home *** CD-ROM | disk | FTP | other *** search
/ Assassins - Ultimate CD Games Collection 4 / Assassins 4 (1999)(Weird Science).iso / adventures_1 / ducksoup / agt_files / untgz.readme < prev    next >
Text File  |  1977-12-31  |  5KB  |  140 lines
  1. Short: Small and efficient tar.gz unarchiver
  2. Uploader: owagner@vapor.com (Oliver Wagner)
  3. Author: owagner@vapor.com (Oliver Wagner)
  4. Type: util/arc
  5. Version: 1.3
  6. Kurz: Kurzer und effizienter tar.gz-Extrahierer
  7.  
  8.  
  9. UnTGZ 1.3
  10. =========
  11.  
  12. Introduction
  13. ------------
  14.  
  15. UnTGZ is a extractor/list for the combined tar/gzip archive format which is
  16. esspecially popular in the unix world.  Actually, a tar.gz (or .tgz)
  17. archive is a collection of files which have been archived with the tar
  18. (tape archive) program, which's output in turn has been compressed using
  19. the gzip packer.  
  20.  
  21. The major advantage of this procedure is that all the files in the archive
  22. are compressed in a single block, instead of single files.  Due to the
  23. nature of the used compression techniques which try to find duplicate
  24. "strings" in the data this yields much better compression ratios
  25. as if all the files would be compressed one by one, because the
  26. search for duplicate data can span several of the source files.
  27.  
  28. As a result, a tar.gz archive in average gives much better compression
  29. ratio than the LHA format which is currently in use in the Amiga
  30. world. The now out-of-development LZX archiver used a similiar
  31. technique, and therefore the tar.gz combination gives similiar
  32. compression ratios than the LZX format.
  33.  
  34. However, the tar.gz format is not in wide use in the Amiga community
  35. because many people find the usage of two programs which have a very
  36. "unixish" syntax just to extract a single archive a bit stressing.
  37.  
  38. UnTGZ, however, is a single, compact program which's sole purpose
  39. is to list and extract tar.gz archives with a mode of operation
  40. similiar to existant archive utilities.
  41.  
  42. Advantages
  43. ----------
  44.  
  45. - UnTGZ is heavily optimized for speed and memory usage.
  46.   Memory requirement for a decompression run is about 80k.
  47.  
  48. - UnTGZ itself is very compact (currently 13k), thus
  49.   saving space on distribution disks. It can be made
  50.   resident.
  51.  
  52. - UnTGZ has been designed in a way that the "look & feel"
  53.   of existant archive utilities like LHA or LZX is
  54.   preserved.
  55.  
  56. - UnTGZ works with AmigaOS 1.2/1.3 machines. No special
  57.   libraries
  58.  
  59. - UnTGZ can be used as a default tool from Workbench
  60.   Project Icons to easily provide "Click&Extract" functionality.
  61.   WB Operation can be customized via icon tooltypes.
  62.   Actions are displayed via standard console windows
  63.   (it will automatically recognize an installed KingCon Handler
  64.   and use a KCON: window for scrollback and appicon support)
  65.  
  66.  
  67. Shell-Usage
  68. -----------
  69.  
  70. Shell usage is very straightforward:
  71.  
  72.  UnTGZ [-v] archivename [destination directory]
  73.  
  74. "-v" specifies that the archive is to be listed, not extracted.
  75.  
  76. "destination directory" optionally specifies the, you guessed it,
  77. destination directory where the files are to be extracted into.  This
  78. defaults to the current directory as to the time of invocation.
  79.  
  80. Note that UnTGZ automatically tries to locate archive files
  81. by appending ".tar.gz" and ".tgz" to the archivename if
  82. no extension is given.
  83.  
  84. Workbench usage
  85. ---------------
  86.  
  87. In order to use UnTGZ from the Workbench, you have to create
  88. project icons for the ".tar.gz" files, which's default tool
  89. points to the UnTGZ executable.
  90.  
  91. You can specify tooltypes in this project icons to customize
  92. UnTGZ's behavior:
  93.  
  94.  Window=con:blabla
  95.  Define the console window used for output and queries.
  96.  Defaults to "CON:0/0/640/400/UnTGZ" for OS 1.2/1.3
  97.  and to "[K]CON:0/0/640/400/UnTGZ/WAIT/CLOSE" for OS2+
  98.  environments.
  99.  
  100.  Destination=Path
  101.  Define destination path. Defaults to "RAM:". This
  102.  can be modified by the user, unless "ForceExtract"
  103.  is specified.
  104.  
  105.  ForceView
  106.  Force display of archive contents, not asking the
  107.  user for actions.
  108.  
  109.  ForceExtract
  110.  Force extraction of files, not asking the user for
  111.  actions.
  112.  
  113.  Message=Text...
  114.  Output this text before asking the user for actions.
  115.  Defaults to no text.
  116.  
  117. You should specify a stack size of 20480 in the project
  118. icon to avoid having UnTGZ allocate it's own stack,
  119. thus saving a few k of memory.
  120.  
  121.  
  122. Copyright
  123. ---------
  124.  
  125. UnTGZ was written by Oliver Wagner <owagner@vapor.com>.
  126.  
  127. The "inflate" decompression code used inside the program was written and
  128. placed in the public domain by Mark Adler.
  129.  
  130. UnTGZ 1.3 may be freely distributed. Commercial usage of any kind
  131. requires prior permission.
  132.  
  133. No warranties of any kind, use on your own risk, don't put in
  134. child's hands etc. You can be assured it won't ObtainSemaphore()
  135. your screen's Layer on input.device schedule, though :-)
  136.  
  137. EMail bug reports and related stuff to <owagner@vapor.com>.
  138.  
  139. See http://www.vapor.com/support/ for other neat stuff.
  140.